home *** CD-ROM | disk | FTP | other *** search
/ CD ROM Paradise Collection 4 / CD ROM Paradise Collection 4 1995 Nov.iso / dskutil / flmas350.zip / FMCONFIG.DOC < prev    next >
Text File  |  1995-01-15  |  13KB  |  253 lines
  1.  
  2.  
  3.                    F  L  O  P  P  Y      M  A  S  T  E  R
  4.  
  5.                                 Version 3.5
  6.  
  7.  
  8.                          ***   CONFIG PROGRAM   ***
  9.  
  10.  
  11. This document will briefly explain how to use Floppy Master's configuration
  12. program, FMCONFIG.EXE. It should be located in the same directory as main
  13. FMASTER.EXE file (it may be renamed) and FMASTER.CFG file (it will be
  14. created the first time you save configuration, if it does not exist yet).
  15.  
  16. You may use the /BW switch to force config program in the monochrome mode,
  17. if autodetection fails to detect it properly.
  18.  
  19.  
  20. 1. Registering Floppy Master
  21. ---------------------------------------------------------------------------
  22. Floppy Master uses key registration codes to register shareware version of
  23. Floppy Master for personal usage. When you have received your registration
  24. code, start the config program and in main menu choose the first option
  25. (Register Floppy Master).
  26.   A form will pop up, asking you to enter the key code and your name,
  27. surname and address. All this data is necessary to register program and
  28. without filling the entire form out you will not be able to continue.
  29. Besides that, each key code is prepared for each registered user separately
  30. and includes his/hers initials. If initials in key code do not match those
  31. of name and surname you have entered, program will not allow you to
  32. register.
  33.   Press F10 when form is properly filled out (or press ESC if you don't
  34. want to continue with the registration process). If there is nothing wrong,
  35. config program will try to patch the main EXE file to register it. If you
  36. have renamed or moved EXE file to other location, config program will not be
  37. able to find it and you will be prompted to enter full path and filename.
  38. You should enter something like 'C:\FMASTER\FMASTER.EXE'.
  39. After that, you should be notified that Floppy Master is successfully
  40. registered. If you still have problems registering Floppy Master, contact
  41. the author to work it out.
  42.  
  43.  
  44. 2. Archivers setup
  45. ---------------------------------------------------------------------------
  46. In this section, you can setup your own archivers for Floppy Master to work
  47. with. Floppy Master will be able to add to the database files inside archive
  48. files, too. Any archiver program will do, as long as it complies to
  49. following conditions:
  50.  
  51. - It must be able to produce list of files in given archive file. List of
  52.   files must be arranged in columns, separated by spaces and it must include
  53.   filename and file size.
  54.  
  55. - DOS redirection must be supported by archiver program when generating file
  56.   list. Floppy Master tries to redirect archiver output in the file and it
  57.   analyzes it later. You may check if your archiver support this by typing
  58.   something like that (this is for ZIP archiver):
  59.     PKUNZIP -V TEST.ZIP > FILELIST.TXT  <Enter>
  60.   A file FILELIST.TXT should be created, containing files in TEST.ZIP.
  61.  
  62. The following archivers have been successfully tested with Floppy Master:
  63. ZIP, ARJ, UC2, LZH, LIM, ARC, RAR.
  64.  
  65. * Archiver RAR seems to have some troubles on some machines. In general, it
  66.   works just fine, but there were some cases of hanging machine up when
  67.   browsing archive. It is not clear yet if this is bug in RAR or in Floppy
  68.   Master...
  69. * Archiver LIMIT (LIM) is not compatible with Floppy Master, since it does
  70.   not fully support DOS redirection.
  71.  
  72. After selecting option in the main menu, you will be presented list of
  73. currently supported archivers. Move the selection bar to empty space to add
  74. a new archiver, or pick existing one to modify setup, and press Enter.
  75.   A dialog box will show up to enter archivers data. Extension is used to
  76. identify archiver type (like ZIP, ARJ etc.)  Wild chars like '*' and '?' are
  77. not supported at the moment. File name and file size columns tell program
  78. where to look for data in file listings, produced by archiver (description
  79. of these follows). Command line to display files in the archive is what you
  80. have to type to get list of files in the archive file. Replace the archiver
  81. filename with !F. !F must be present in the command line, since it stands
  82. for filename to look inside it.
  83. For PkZip archiver, that line should be:
  84. PKUNZIP.EXE -V !F
  85.  
  86. This line should produce something like that:
  87.  
  88. -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -
  89.  
  90. PKUNZIP (R)    FAST!    Extract Utility    Version 2.04g  02-01-93
  91. Copr. 1989-1993 PKWARE Inc. All Rights Reserved. Shareware Version
  92. PKUNZIP Reg. U.S. Pat. and Tm. Off.
  93.  
  94. ■ 80486 CPU detected.
  95. ■ EMS version 4.00 detected.
  96. ■ XMS version 2.00 detected.
  97. ■ DPMI version 0.90 detected.
  98.  
  99. Searching ZIP: FM310.ZIP
  100.  
  101.  Length  Method   Size  Ratio   Date    Time    CRC-32  Attr  Name
  102.  ------  ------   ----- -----   ----    ----   -------- ----  ----
  103.   51513  DeflatX  50427   3%  09-27-94  05:51  47a31e8d --w-  FMASTER.EXE
  104.    9807  DeflatX   3766  62%  09-03-94  10:35  9aeb2441 --w-  WHATSNEW.DOC
  105.   26561  DeflatX   9918  63%  09-27-94  05:50  6928928a --w-  MANUAL.HLP
  106.     458  DeflatX    259  44%  09-04-94  07:02  e45179d7 --w-  FILE_ID.DIZ
  107.  ------          ------  ---                                  -------
  108.   88339           64370  28%                                        4
  109.  
  110. -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -  -
  111.  
  112. Now, back to filename in file size columns. The output produced by archiver
  113. program is divided in columns, as length, method, size etc. Floppy Master
  114. will need to know which column is for filenames and which is filled with
  115. files original sizes. For PkZip archiver, the proper columns are no. 9 for
  116. filenames and no. 1 for file sizes:
  117.  
  118.   51513  DeflatX  50427   3%  09-27-94  05:51  47a31e8d --w-  FMASTER.EXE
  119.   ^^^^^  ^^^^^^^  ^^^^^  ^^^  ^^^^^^^^  ^^^^^  ^^^^^^^^ ^^^^  ^^^^^^^^^^^^
  120.   No.1    No.2    No.3   No.4   No.5     No.6    No.7   No.8     No.9
  121.  
  122.  
  123. *******************
  124.    NOTE THIS !!!
  125. *******************
  126.  
  127. If filename is displayed in two columns, like
  128.   README    DOC
  129.   TEST      ZIP
  130.   FMASTER   EXE,
  131. count this as one single column! Floppy Master will figure it out that those
  132. two fits together and will handle them as one!  UltraCompressor II (UC2) is
  133. an example of archiver which produces such output.
  134.  
  135. When all data in the dialog box is filled in, press ESC to update and return
  136. to archiver list. If you would like to cancel changes in the dialog box,
  137. press the F10 key.
  138.  
  139. ******************************************
  140. If something does not work as it should...
  141. ******************************************
  142.  
  143. If any of the settings are not in order, program will most likely respond by
  144. not recognizing archive files (on the file list, files will not have the
  145. "Arc" attribute set after modifying data and will behave as all other normal
  146. files). If this happens, check the following:
  147. - check if command line you have entered works. Write the same one at
  148.   command prompt and check if it works. Try to redirect the resulting list
  149.   in the file (as mentioned above) to check if archiver is compatible with
  150.   Floppy Master. Remember, if your archiver program is not in the path, you
  151.   must specify full path to the program.
  152. - check again if column numbers in the file list match those in the config
  153.   program. This is most likely to be the cause of an error. Again, archiver
  154.   program must be able to produce file list in text format, one line for
  155.   each file in the archive (no empty lines between files or something).
  156. - if archiver is none of those tested with Floppy Master, it may be possible
  157.   that program can not recognize column structure correctly. If you suspect
  158.   this might be the case, contact the author and provide him with file
  159.   listing, generated by your nonworking archiver.
  160.  
  161.  
  162. 3. Enable browsing archive files
  163. ---------------------------------------------------------------------------
  164.  
  165. If archive file browsing is enabled, Floppy Master will try to collect list
  166. of files inside archive files such as ZIP, ARJ, etc. when modifying disk
  167. data. If option is disabled, archive files are treated as all the others.
  168. You may also set this option in Floppy Master, too, before starting the
  169. process of collecting data.
  170. Enabling this option will make modifying disk data much slower, since
  171. program has to call an external archiver for each archive file it finds.
  172. Also, database size may expand in size for few times if archive browsing is
  173. enabled. It is recommended that you turn archive browsing off in the config
  174. program and manually turn it on in Floppy Master only when you are going to
  175. modify disk data for disks with archive files you would like to browse
  176. trough when in the database.
  177. When modifying disk data for CD-ROMs, it is strongly recommended that you
  178. don't enable archive browsing. You may wait even for an hour or so for
  179. process to complete and end up with very large database.
  180.  
  181.  
  182. 4. Auto file descriptions
  183. ---------------------------------------------------------------------------
  184. This is another option that applies to modifying disk data. If auto file
  185. descriptions are enabled, Floppy Master will search for FILES.BBS and
  186. DESCRIPT.ION and try to import file descriptions from there. Enabling this
  187. option will also increase time to complete operation.
  188. Keep in mind that databases with a lot of file descriptions are very large
  189. and slow to modify, so try using file descriptions with some sense.
  190.  
  191.  
  192. 5. Size of memory file buffers
  193. ---------------------------------------------------------------------------
  194. Floppy Master uses kind of virtual memory to handle databases. An important
  195. part of memory management are file buffers, used to improve speed when
  196. working with database. File buffers should be as large as possible, but
  197. small enough to leave some memory still free for program to work with.
  198. Default setting is up to 60% of program memory dedicated to file buffers.
  199. This should do in most cases, however if you run out of memory, make file
  200. buffers smaller. You can also minimize file buffers, leaving them just 4kB
  201. of memory and have as much free memory as possible in cost of some
  202. degradation in program speed.
  203.  
  204.  
  205. 6. Create file index
  206. ---------------------------------------------------------------------------
  207. When browsing disk in a large database, it may take a while for program to
  208. find files for a chosen disk. If file index creating is enables, Floppy
  209. Master will create index of files every time you choose do display disk
  210. info (this will take an extra second or two), but disk browsing will be
  211. considerably faster. If you don't intend to browse disks a lot or your
  212. database in quite small, you should probably disable file index.
  213.  
  214.  
  215. 7. Confirm disk data overwrite
  216. ---------------------------------------------------------------------------
  217. If you try to modify disk data in the database, existing disk data for that
  218. disk is normally replaced with the new one. If you like to, you may enable
  219. this option and program will request that you confirm disk data replacement.
  220. Recommended is not to bother with this, just turn it off.
  221.  
  222.  
  223. 8. Archive files and optimization
  224. ---------------------------------------------------------------------------
  225. When optimizing floppy disks, there are two ways to treat archive files. If
  226. archive files are treated as directories, they may be moved to another
  227. location without any connection to other files in the directory. If they are
  228. treated as normal files, they are only a part of directory and may not be
  229. separated from other files in the directory.
  230.   Be advised: if you instruct Floppy Master to treat archive files as
  231. standalone directories, program will need much greater memory resources to
  232. successfully complete the task. Optimizing disks is a very complex task and
  233. requires a lot of free memory - adding so many extra directories to handle
  234. may simply be too much.
  235.  
  236.  
  237. 9. Display type (mono, color)
  238. ---------------------------------------------------------------------------
  239. With this option, you may force Floppy Master to work in color or monochrome
  240. mode, or leave the decision to the program.
  241.  
  242.  
  243. 10. Time format
  244. ---------------------------------------------------------------------------
  245. Nothing much to say, choose between 12-hour and 24-hour time format display
  246. in the status line.
  247.  
  248.  
  249.  
  250. *************************************************************************
  251. *      Remember to save configuration when exiting config program       *
  252. *************************************************************************
  253.